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PART 13 

CHAPTER 1 

INTRODUCTION TO FILCOM 

File Compare (FILCOM), a system program for use under the DOS /BATCH Monitor, allows 
a user to compare an ASCII l source dataset to a second ASCII source dataset and then 
creates a dataset of the differences. 

Two sets of option switches allow FILCOM to handle different types of comparisons, 
and help the user select exactly what he wants to compare. 

FILCOM can be run when the DOS /BATCH Monitor prints a $ (dollar sign, signifying 
readiness to load a program) by typing 

RUN FILCOM 

at the keyboard. FILCOM then prints a #, indicating readiness to accept commands. 



NOTE 



Although FILCOM can be used only to compare ASCII 
files, it can be used indirectly to compare binary 
files. The user should first run the FILDMP pro- 
gram and dump each binary file onto some retrievable 
medium such as disk, DECtape, or paper tape. The 
ASCII output files generated by FILDMP can then be 
compared using FILCOM. 



American Standard Code for Information Interchange. 
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PART 13 

CHAPTER 2 

FILCOM COMMANDS 

FILCOM commands are processed by the DOS/BATCH Command String Interpreter (CSI) . 
This assures a command language consistent with other system programs operating 
under DOS/BATCH. Consult Chapter 3-6 for a complete description of the CSI. 

2.1 FILCOM COMMAND FORMAT 

Note that FILCOM commands are always typed in response to a # character. 

To compare a master file and a new version of that file, use the following command 
format: 

list dataset<master dataset,newmaster dataset 

where : 



list = specification of the output dataset on which a list of the differences 
dataset between the two files (if any) will be written. 

master - the specification of the master dataset. 
dataset 

newmaster = the specification of the newer version of the master dataset (or a 
dataset Copy of the master dataset) . 

For example, to compare the files MASTER. OLD and MASTER. NEW, listing the differences 
(if any) on the line printer, the following command is used: 

LP :<MASTER. OLD, MASTER. NEW 



2.2 OPTION SWITCHES 

The two sets of option switches available for use with FILCOM are: 

1. LOCAL switches 

2. GLOBAL switches 
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2.2.1 LOCAL Switches 

LOCAL switches enable the user to select the type of comparison he wishes to make 
between the two files. LOCAL switches can be placed anywhere in a command string 
if the correct command format is followed. There can be one or more LOCAL switches 
in each command string. 

EXAMPLES: LP:<FILE.ONE/switch,FILE.TWO 
LP : <FILE . ONE , FILE . TWO/switch 
LP:/switch<FILE.ONE,FILE.TWO - 

If two switches of the same type are specified in one command string, the rightmost 
switch specification takes precedence. 

The following LOCAL switches are available . to the user : 



/SC:n = ASCII source compare for n lines 
/BL:OFF = compare blank lines 

{/BL: 0N } = ign ° re blank 1±neS 
/TR:OFF = compare trailing blanks within lines 

I/tr-on I = i ^ nore trailing blanks within lines 

/MB = reduce multiple blanks to a single blank 
/DE = delete old list file (if it exists) .. 

2.2.1.1 The SC (Source Compare)- Switch 

The format of the SC switch is 

/SC:n 

where n is a decimal integer specifying the number of consecutive lines that 
constitutes the minimum unit of comparison. A unit of comparison in the newmaster 
file must match a unit of comparison in the master file to establish a successful 
comparison. Since the default unit of comparison is a single line, small recurring 
sets of lines that are identical in two dissimilar files will cause a successful 
comparison. Use of the SC switch will prevent this occurrence, and condense the 
comparison listing. 
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EXAMPLES: 

LP : /SC : 3<FILE . ONE , FILE . TWO 

LP : /SC : 2<FILE . ONE/SC : 4 ,FILE . TWO 

2.2.1.2 The BL (Blank Lines) Switch 
The format of the BL switch is 



(Three lines must match for a successful 
comparison. ) 

(Four lines must match for a successful 
comparison; note that the rightmost switch 
is accepted and takes precedence in this 
command . ) 



( /BL ) 
</BL:ON 

(/BL:OFFJ 



where /BL:OFF indicates that blank lines are to be included in comparisons, and /BL 
or /BL.-ON indicates that blank lines are to be ignored during comparisons. Blank 
lines appear in the difference file or listing, and are accounted for in line 
numbers regardless of the setting of the BL switch. 



EXAMPLES: 

LP : /BL : OFF<FILE . ONE , FILE . TWO 
LP : /BL<FILE . ONE , FILE . TWO 
LP : <FILE . ONE/BL : ON , FILE . TWO 



(include blank lines during comparison) 
(ignore blank lines in comparison) 
(ignore blank lines in comparison) 



If the BL switch* is not specified, a default value of /BL:ON is used. 



2.2.1.3 The TR (Trailing Blanks) Switch 



The format of the TR switch is 



(/TR ) 
</TR:ON j 
(/TR:OFFJ 



where /TR or /TR:ON indicate that trailing blanks are ignored, and /TR:OFF indicates 
that trailing blanks are significant and are to be included in comparisons. 



EXAMPLES : 

LP : <FILE . ONE , FILE . TWO/TR 

LP : <FILE . ONE/TR: ON , FILE . TWO 

LP:/TR:OFF<FILE.ONE,FILE.TWO 



(ignore trailing blanks in comparison) 
(ignore trailing blanks in comparison) 
(include trailing blanks in comparison) 



If the TR switch is not specified, a default value of /TR:ON is used. 
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2.2.1.4 The MB (Multiple Blanks) Switch 
The format of the MB switch is 

/MB 

When included in a command string, the MB switch indicates that multiple non- 
trailing blanks within a line are to be regarded as single blanks for comparisons. 
TAB characters are considered to be multiple blanks. If the MB switch is not 
specified, multiple non-trailing blanks are counted separately during comparisons. 

2.2.1.5 The DE (Delete Existing) Switch 
The format of the DE switch is 

/DE 

When included in a command string, the DE switch indicates that if a specified list 
dataset exists, it is to be deleted prior to command execution. If such a dataset 
exists and the DE switch is not specified, an error results because of the conflict 

in filenames. 

* 

EXAMPLE: 

DTI: LIST. FIL/DE<FILE. ONE, FILE. TWO If a file named LIST.FIL already exists 

on DECtape 1, delete it before attempting 
to create LIST.FIL for this command. 

2.2.2 GLOBAL Switches 

GLOBAL switches are used to specify a default condition for the execution of a 
series of commands to follow. They differ from LOCAL switches in the following ways: 

1. GLOBAL switches influence a series of commands; LOCAL switches influence 
only the commands in which they occur. 

2. Only one GLOBAL switch is permitted in a command string; multiple LOCAL 
switches are permitted in the same command string. 

3. No file comparison can Be made in the command string that contains a 
GLOBAL switch; file comparisons can be made in command strings containing 
LOCAL switches. 
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An example of the use of a GLOBAL switch: 

<LP:/LS:ON 

<FILE . ONE , FILE . TWO 

<FILE . OLD .FILE . NEW 

<LS:OFF 

As a result of the command strings shown in the above example, differences between 
the files specified in the command strings are listed at the line printer. 
Command strings following the /LS:OFF switch must specify the output device for 
the difference listing. 

The following GLOBAL switches are available: 

/DF - sets default conditions for one or more LOCAL switches. 

/IN - reads and interprets the contents of a specified file as FILCOM commands. 

/LO - writes a log of all commands executed indirectly through use of the 
/IN switch, 

/LS - specifies the output dataset for FILCOM difference listing. 
2.:>.2.1 The DF (Define Default) Switch 
The format of the DF switch is: 

{/DF/sw:df [/sw:df . . . ] 
/DF : ON/sw : df [/sw : df . . . ] 
/DF : OFF 

where /DF or /DF:ON followed by one or more local switch specifications serves to 
set default conditions for those switches. The specification /DF:OFF returns all 
LOCAL switches to their original default conditions (described previously) . 

EXAMPLES: 



/DF:ON/DE:ON (Sets the default condition of the DE 

switch to ON; i.e., until the DF switch is 
turned OFF, list datasets with the same 
name as those specified in a command 
string are deleted prior to execution of 
the command) . 

/DF/DE:ON/TR:OFF (Sets the default condition of the DE 

switch to ON as described above; also 
sets the default condition of the TR 
switch to OFF — trailing blanks are sig- 
nificant until the DF switch is turned OFF), 

/DF:OFF (Returns all previously specified LOCAL 

switches to normal default conditions) 
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2.2.2.2 The IN (Indirect Commands) Switch 



The format of the IN switch is 



{dataset/IN 
dataset/IN 
/IN: OFF 



:0N> 



The dataset specified with the IN switch is any legal DOS/BATCH input dataset 
indicating a file whose contents can be read and executed as FILCOM commands. 

The last command in the indirect command file can be /IN:OFF canceling the IN 
switch; however, an end-of-file condition reached in that file also has the 
effect of turning OFF, the IN switch. The command /IN: OFF can be issued from the 
keyboard, but has no effect until FILCOM has completed processing the specified 
input file; since the end-of-file condition turns off the IN switch, it is 
redundant to type /IN: OFF at the keyboard. 

Once the IN switch has been turned ON at the keyboard, indirect command execution 
begins after the user presses CTRL/C (control-C) and types BEGIN. 

Indirect command files (files specified with the IN switch) can be chained, but 
care must be taken not to chain a file that chains (directly or indirectly) to the 
current file. 

EXAMPLES: 



DT2:FILE.IND/IN 



FILE.IND/IN:ON 



/IN: OFF 



Causes the contents of FILE.IND on DECtape 
2 to be read and interpreted as FILCOM 
commands . 

Causes the contents of FILE.IND on the 
system device to be read and interpreted 
as FILCOM commands. 

When typed at the keyboard, has no effect; 
when included in an indirect file, it termi- 
nates indirect interpretation. 



2.2.2.3 The LO (LOg dataset) Switch 



The format of the LO switch is 



!dataset/LO 
dataset/LO 
/LO:OFF 



:ON? 
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The LO switch is used to specify a log dataset. Commands specified in an indirect 
command file are listed in this log when they are encountered. Keyboard commands 
are also listed in this log dataset; it is thus redundant to specify the keyboard 
as the log dataset if commands are being entered normally through the keyboard. 
All list file information is also duplicated in the file specified in the log 
dataset. The command /LO:OFF terminates use of the previously specified log dataset; 
the LO switch can be turned OFF in this manner either at the keyboard or within the 
command coding in an indirect file. 

EXAMPLES : 



<LP:/LO:ON 

<DTO : LINES . IND/IN 

<FILE . ONE , FILE • TWO 



<DT4: LINES. LOG/LO 
<LINES. IND/IN 
</LO:OFF 



Specifies the line printer as a log data- 
set; commands read indirectly from the 
file LINES. IND on DECtape unit are 
listed at the line printer. Also, the 
files FILE. ONE and FILE. TWO on the system 
device are compared; the output list is 
duplicated at the line printer. 

Specifies the file LINES.LOG on DECtape 
unit 4 as a log dataset; commands read 
indirectly from the file LINES. IND on the 
system device are duplicated in this 
file. List output will also be duplicated 
in this file. After LINES. IND has been 
read and executed, the file LINES.LOG is 
terminated as a log. 



2.2.2.4 The LS (List dataset) Switch 



The format of the LS switch is 



!dataset/LS 
dataset/LS:ON 
/LS:OFF 



where the commands /LS or /LS:ON specify a default list dataset to be used for 
subsequent commands; this dataset is used until terminated by the LS-.OFF command. 
A new default dataset can be specified without turning the LS switch OFF, as shown 
in the example below. 



EXAMPLE: 

<LP:/LS 

<FILE . ONE , FILE . TWO 

<DT1:LIST.FILE/LS 

<FILE. SIX, FILE, TEN 

<FILE . OLD , FILE . NEW 

</LS:OFF 



The line printer is the default list data- 
set when comparing the files FILE. ONE and 
FILE. TWO; the file LIST.FIL on DECtape 
unit 1 is the default list dataset when 
comparing files FILE. SIX and FILE. TEN, and 
when comparing files FILE. OLD and FILE. NEW. 
The /LS:OFF specification terminates the 
default list dataset; subsequent commands 
must contain a list dataset specification 
until the LS switch is turned on again. 
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PART 13 

CHAPTER 3 

SAMPLE OUTPUT 



3.1 OUTPUT FROM FILCOM 

Output from FILCOM consists of the following elements: 

1. A copy of the FILCOM command that initiated the compare, 

2.- For the master copy, the line number of the difference detected followed 
by the associated text, 

, 3. For the new master, the line number of the difference detected followed 
by the associated text. 

Figure 13-1 illustrates sample output from FILCOM generated by comparing two 
versions of the Gettysburg Address. 



******************************************** 

******************************************** 

KB:<DT0;FILE01.FIL,DT0:FILE02.FIL 

******************************************** 

******************************************** 

MASTER LINE 00002 

THIS CONTINENT A NEW NATION CONCEIVED IN LIBERTY AND DEDICATED TO 
THE PROPOSITION THAT ALL MEN ARE CREATED EQUAL. 



NEW MASTER LINE 00002 

THIS CONTINENT AN OLD NATION CONCEIVED IN LIBERTY AND DEDICATED TO 
THE PROPOSITION THAT ALL MEN ARE CREATED EQUAL. 

******************************************** 



Figure 13-1 Sample FILCOM Output 
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